home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / archiver / belef.lzh / BELEF202.TXT < prev    next >
Text File  |  1993-07-27  |  63KB  |  1,522 lines
  1.  *%*%*%*%*%*%*%*%*%*%*%*%*%*%*%*%*%*%*%*%*%*%*%*%*%*%*%*%*%*%*%*%*%*%*%*%*%*%*%
  2. %                                                                              %
  3. %                                   BELEF II                                   %
  4. %                                                                              %
  5. %                              pronounced: BELL*EFF                            %
  6. %                                                                              %
  7. %                 Uncle Carl's Famous Archive Shell & Converter                %
  8. %                 =~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=                %
  9. %                    (C) Carl J. Hafner - ALL RIGHTS RESERVED                  %
  10. %                                 Version 2.02                                 %
  11. %                                                                              %
  12.  *%*%*%*%*%*%*%*%*%*%*%*%*%*%*%*%*%*%*%*%*%*%*%*%*%*%*%*%*%*%*%*%*%*%*%*%*%*%*%
  13.  
  14.                           RELEASE DATE: July 27, 1993
  15.  
  16.     Belef can best be described as a universal compression utility shell.
  17.     It is universal in the sense that it should work with ANY compression
  18.     utility, past, present or future ! ALL of the functions associated
  19.     with your favorite parameter taking compression utility are available,
  20.     as well as the ability to convert one form of archival storage file
  21.     into another with a minimum of effort !
  22.  
  23.     Belef works on all ST/STe/TT computers in medium and high resolutions.
  24.  
  25.  
  26.                                    DISCLAIMER
  27.     -%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-
  28.     The author cannot be responsible for any damage to your equipment, other
  29.     software or hardware products, or physical or mental well being caused
  30.     by the use, misuse, abuse or inability to use this program.
  31.  
  32.     The author also makes no guarantee as to the compatibility of this
  33.     program with other software or hardware products.
  34.  
  35.     Using this program means that you completely understand AND agree with
  36.     these terms. If you do NOT understand AND agree, DO NOT use this program.
  37.     -%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-
  38.  
  39.                                     CAUTION
  40.     -%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-
  41.     Belef works by allowing YOU to configure and save the interface settings.
  42.     If an error occurs AFTER you have instructed Belef to carry out your
  43.     instructions, it is POSSIBLE that you may have entered the commands
  44.     incorrectly. PLEASE be certain to enter the correct command codes 
  45.     (available with your compression utility) and control codes (where
  46.     applicable) on the configuration screen.
  47.     -%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-
  48.  
  49.  
  50.                                 TABLE OF CONTENTS
  51.                                 -----------------
  52.  
  53.   INTRODUCTION
  54.  
  55.   1) MAIN PANEL
  56.        a) Command Buttons
  57.        b) Option Buttons
  58.        c) Execute Buttons
  59.        d) Convert Button
  60.        e) Arrows
  61.            Identifying LZH formats
  62.        f) Exit Button
  63.   2) PREFERENCES
  64.        a) Confirmation prompts
  65.        b) Pause after TOS Apps
  66.        c) Confirm Overwrites
  67.        d) Mouse Snapping
  68.            UncleMouse support (.CUR files)
  69.        e) Select Buttons
  70.   3) CONFIGURE
  71.        a) Utility
  72.        b) Commands
  73.        c) Control Code commands
  74.        d) Names
  75.        e) Options
  76.        f) Encryption
  77.        g) TEMPorary work directory
  78.        h) Scrolling Setups / Button
  79.        i) Load
  80.            Default files
  81.        j) Save
  82.        k) Fsel
  83.        l) Okay
  84.        m) Cancel
  85.   4) COMMAND
  86.        a) Buttons
  87.        b) Command Line
  88.        c) File
  89.        d) TEMP
  90.        e) Execute
  91.        f) Convert
  92.        g) Fsel
  93.        h) Exit
  94.   5) FILE
  95.        a) Copy/Move file
  96.        b) Delete file
  97.        c) Rename file
  98.        d) Disk space
  99.        e) Create folder
  100.        f) Delete folder
  101.        g) Rename folder
  102.        h) Menu Bar
  103.        i) Exit
  104.   6) EXTRACTION OPTIONS
  105.        a) All
  106.        b) Folder
  107.        c) Query
  108.        d) Cancel
  109.   7) SELECTING TEMP DIRECTORIES
  110.   8) CREDITS
  111.   9) DISTRIBUTION
  112.  10) REGISTRATION
  113.  11) VERSION HISTORY
  114.  12) TROUBLESHOOTING
  115.          Memory allocation (MALLOC)
  116.          .ZOO compatibility
  117.          Mouse snapping
  118.  13) OTHER STUFF
  119.        a) Fileselector messages
  120.        b) Fileselector paths
  121.        c) About archive files
  122.        d) RAM disks
  123.        e) Sample session
  124.  14) CONTROL CODES ADDENDUM
  125.  15) INDEX
  126.  
  127.  
  128.                                   INTRODUCTION
  129.                                   ------------
  130.    The biggest problem I've personally encountered with archive shells was
  131.    that most of them were too inflexible. That is to say that they either
  132.    worked with only specific compression utilities or they didn't allow
  133.    FULL access to ALL of the features available from within that utility.
  134.    
  135.    With that in mind, I designed Belef so that it worked like a command
  136.    line interface box (the kind you get when you double-click on a .TTP
  137.    program from the GEM desktop) with the ease of simply selecting buttons.
  138.  
  139.    Belef works by allowing YOU to enter commands and options on a
  140.    configuration screen. You then add a descriptive name TO that function
  141.    and Belef automatically passes YOUR name, command and options to the
  142.    buttons on the front panel. Selecting that button registers YOUR
  143.    commands and options !
  144.  
  145.    This should allow Belef to be compatible with any parameter taking
  146.    utility, past, present or future. If someone upgrades their compression
  147.    utility, you need merely change your commands on the configuration screen
  148.    (if necessary).
  149.  
  150.    Belef also holds the names, commands and options for 2 compression
  151.    utilities AND allows you to save and load either complete OR
  152.    individual setups ! For example, one setup can be for .ARC and .LZH
  153.    files and another can be for .ZOO and .ZIP files (or any combination
  154.    you like).
  155.  
  156.    While Belef DOES come with a basic setup file, configuring it to your
  157.    OWN needs may require a little more "fine tuning". Take the time to read
  158.    this text file so that you may take FULL advantage of the features, and
  159.    flexibility, of Belef !
  160.  
  161.  
  162.                                    
  163.     1)                             MAIN PANEL
  164.                                    ----------
  165.                                    
  166.     [command] [option] [archive name] [disk name/directory/pathname]
  167.  
  168.  
  169.     The first thing to appear when you run Belef is the Main Panel. This is
  170.     the panel from which you will perform your archiving procedures.
  171.  
  172.     You will note 2 sets of 20 buttons each contained within a darker
  173.     background. The set of 20 buttons on top are the commands and options
  174.     for the first archive utility. The set of 20 buttons on the bottom
  175.     are the commands and options for the second archive utility.
  176.  
  177.  
  178.  a) COMMAND BUTTONS
  179.     ---------------
  180.     These are the first 10 buttons within the first set of buttons (on the
  181.     top of the panel) and the first 10 buttons within the second set of
  182.     buttons (on the bottom half of the panel).
  183.  
  184.     The command buttons are used, as the name implies, to select the
  185.     "command" (or function) that you wish the archive utility to perform. 
  186.  
  187.     The COMMAND buttons are "radio buttons", meaning that you may only select
  188.     one command button at a time. These are like the old car radio buttons
  189.     where the selected button becomes deselected when a new one is chosen
  190.     (anybody remember them ? :-) .
  191.  
  192.     A "command" lets the archive utility know exactly what you wish to do
  193.     with/to an archived file. A command can be something like EXTRACT (the
  194.     archived file) or LIST (the contents of the archived file).
  195.  
  196.     Click on a command button to select it. When you eventually click on
  197.     the execute button, Belef will pass your selected command on to the
  198.     archive utility.
  199.  
  200.     -%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-%-
  201.     The "Command" button in t